home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / lib / c / bstring / RCS / bstring.man,v < prev    next >
Text File  |  1992-03-27  |  2KB  |  116 lines
  1. head     1.2;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    ; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.2
  10. date     92.03.27.12.26.00;  author shirriff;  state Exp;
  11. branches ;
  12. next     1.1;
  13.  
  14. 1.1
  15. date     90.09.06.11.10.15;  author shirriff;  state Exp;
  16. branches ;
  17. next     ;
  18.  
  19.  
  20. desc
  21. @@
  22.  
  23.  
  24. 1.2
  25. log
  26. @Added include info.
  27. @
  28. text
  29. @.\" Copyright (c) 1983 Regents of the University of California.
  30. .\" All rights reserved.  The Berkeley software License Agreement
  31. .\" specifies the terms and conditions for redistribution.
  32. .\"
  33. .\"    @@(#)bstring.3    6.3 (Berkeley) 11/18/87
  34. .\"
  35. .TH BSTRING 3  "November 18, 1987"
  36. .UC 5
  37. .SH NAME
  38. bcopy, bcmp, bzero, ffs \- bit and byte string operations
  39. .SH SYNOPSIS
  40. .nf
  41. #include <bstring.h>
  42. .PP
  43. .B bcopy(src, dst, length)
  44. .B char *src, *dst;
  45. .B int length;
  46. .PP
  47. .B bcmp(b1, b2, length)
  48. .B char *b1, *b2;
  49. .B int length;
  50. .PP
  51. .B bzero(b, length)
  52. .B char *b;
  53. .B int length;
  54. .PP
  55. .B ffs(i)
  56. .B int i;
  57. .fi
  58. .SH DESCRIPTION
  59. The functions
  60. .IR bcopy ,
  61. .IR bcmp ,
  62. and
  63. .I bzero
  64. operate on variable length strings of bytes.
  65. They do not check for null bytes as the routines in
  66. .IR string (3)
  67. do.
  68. .PP
  69. .I Bcopy
  70. copies 
  71. .I length
  72. bytes from string
  73. .I src
  74. to the string
  75. .IR dst .
  76. .PP
  77. .I Bcmp
  78. compares byte string
  79. .I b1
  80. against byte string
  81. .IR b2 ,
  82. returning zero if they are identical,
  83. non-zero otherwise.  Both strings are
  84. assumed to be
  85. .I length
  86. bytes long.
  87. .B Bcmp
  88. of
  89. .I length
  90. zero bytes always returns zero.
  91. .PP
  92. .I Bzero
  93. places
  94. .I length
  95. 0 bytes in the string
  96. .IR b1 .
  97. .PP
  98. \fIFfs\fP finds the first bit set in the argument passed it and returns
  99. the index of that bit.  Bits are numbered starting at 1, from the right.
  100. A return value of 0 indicates the value passed is zero.
  101. .SH BUGS
  102. The
  103. .I bcopy
  104. routine take parameters backwards from
  105. .IR strcpy .
  106. @
  107.  
  108.  
  109. 1.1
  110. log
  111. @Initial revision
  112. @
  113. text
  114. @d13 2
  115. @
  116.